home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 July / EnigmA AMIGA RUN 09 (1996)(G.R. Edizioni)(IT)[!][issue 1996-07 & 08][EARSAN CD VIII].iso / earcd / util3 / ais.lha / AIS / AIS.readme < prev    next >
Text File  |  1996-06-09  |  6KB  |  155 lines
  1. Short:    Calculate the total size of an Aminet index
  2. Version:  1.4
  3. Author:   peoyli@pluggnet.se (P-O Yliniemi)
  4. Uploader: peoyli@pluggnet.se (P-O Yliniemi)
  5. Type:     util/misc
  6. Replaces: AIS.lha
  7.  
  8. Usage:
  9.       AIS LISTNAME/A, SIZECOL/N
  10.  
  11.       LISTNAME - name of the list to add all sizes in
  12.  
  13.       SIZECOL  - column with the size specifier ("K", "M" or "?")
  14.                  SIZECOL is optional, and defaults to column 34.
  15.  
  16. Size:
  17.       1016 bytes! Still below 2 disk blocks!
  18.  
  19. Requirements:
  20.       An Amiga, stack can be as low as 1600 bytes (the
  21.       program uses only 950 bytes of it, but the system
  22.       can't set the stack to a lower value than 1600).
  23.  
  24.       At least 15K mem is required for proper operation.
  25.  
  26.       An Aminet index file (tested with RECENT and INDEX)
  27.       or any other file in the same format ("K", "M" or "?"
  28.       at column 36, size in columns 32-35, formatted as KKKK
  29.       or M.M). ^^- Now selectable!!!
  30.       
  31. Memory usage:
  32.       Two modes of operation, depending on the amount of
  33.       available memory. Loads the whole index into memory
  34.       if possible.
  35.  
  36.       Both modes:
  37.           13464 bytes to display the requester at end
  38.  
  39.       Fast mode: (index size + stack + 1780 bytes)
  40.          + 1600 bytes for the minimum stack (normally 4k)
  41.          + 1852 bytes for the program and its data
  42.          + a free mem block of at least the size of the index
  43.  
  44.       Slow mode: (stack + 1976 bytes)
  45.          + 1600 bytes for the minimum stack (normally 4k)
  46.          + 2048 bytes for the program and its data
  47.  
  48. History:
  49.  
  50.   1.4 - Added support for files up to 999M in size. Previous
  51.     versions didn't support the size format xxM. Now the
  52.     following size formats are supported:
  53.  
  54.     kkkkK    1234K (not used by Aminet)
  55.      kkkK     123K, 12K, 3K
  56.      0.kM     0.9M (not used by Aminet)
  57.      m.kM     1.2M
  58.     mm.kM   75.2M (not used by Aminet)
  59.      mmmM     123M (not used by Aminet - Yet)
  60.       mmM      12M
  61.        mM       1M (not used by Aminet)
  62.  
  63.     Inverted history :-). Size 1016 bytes.
  64.  
  65.   1.3 - Changed default size column to 34. Released 13-Feb-96.
  66.         Size 996 bytes.
  67.  
  68.   1.2 - Low mem bug fix, added command line option, doesn't
  69.         count lines beginning with '|'. Released 22-Jun-95.
  70.         A new argument that allows you to specify at which
  71.         column the size specifier is located.
  72.         Size 1016 bytes.
  73.  
  74.   1.1 - Rewritten in assembly language (800 times faster).
  75.         Added version string. Released 15-Jun-95. Size:
  76.         936 bytes :-).
  77.  
  78.   1.0 - Coded in ARexx, SLOW! Released 13-Jun-95. Size 3064
  79.         bytes :-(.
  80.  
  81. Bugs: Doesn't support Aminet files larger than 99.9M (Aminet
  82.       index file contains space for files up to 9.9M).
  83.  
  84.       Total size must be smaller than 429496729.5K (around
  85.       419430M or 409G). This is smaller than the limit for
  86.       the previously released ARexx version. When Aminet is
  87.       close this size, I will remove this limit (and decrease
  88.       the precision of the calculations).
  89.  
  90.       No more than 4294967295 files can be added to the total
  91.       size (Aminet is now about 17300 files). When Aminet is
  92.       growing towards this limit (in about 90000 years or so),
  93.       I will fix this bug.
  94.  
  95. Speed:
  96.       Tested with the Index file (30-May-95, 1175420 bytes,
  97.       16508 lines). See notes for each test below.
  98.  
  99.       |---------|-------|-----------|-----------|------|---------|
  100.       | Version | Files | Size in K | Size in M | Time | Lines/s |
  101.       |---------|-------|-----------|-----------|------|---------|
  102.       | ARexx   | 16499 | 2551349.2 |    2491.5 | 1610s|    10.2 |  ¹)
  103.       | Asm (F) | 16499 | 2541109.4 |    2481.5 | 2.00s|  8249.5 |  ²)
  104.       | Asm (S) | 16499 | 2541109.4 |    2481.5 |15.08s|  1094.1 |  ³)
  105.       |---------|-------|-----------|-----------|------|---------|
  106.       | Asm (F) | 16499 | 2541109.4 |    2481.5 |19.34s|   853.1 | 68000
  107.       | Asm (S) | 16499 | 2541109.4 |    2481.5 |116.5s|   141.6 | 68000
  108.       |---------|-------|-----------|-----------|------|---------|
  109.  
  110.       ¹) The ARexx version was tested using Edge v1.704. The window
  111.          with the file was as small as possible, all programs that
  112.          could use up some CPU time was disabled (screenblankers etc.)
  113.          The timing was done with a stop watch.
  114.  
  115.       ²) Asm (F) means that there was enough memory to buffer the
  116.          whole file. Timing done using my own hardware-banging timer
  117.          (not released - yet). The timer's precision is around 1/50s.
  118.  
  119.       ³) Asm (S) means SIMULATED low mem situation. The program will
  120.          probably be slower in a real low mem situation. The program
  121.          reads the file line by line when you're almost out of mem.
  122.  
  123.       ** All tests done with an A500+, VXL-030 33MHz/FPU 25MHz, 2M CHIP,
  124.          8M 16-bit mem, and 8M 32-bit mem (around 10.5 * A500).
  125.  
  126.       Results:
  127.  
  128.       (ftp.luth.se) 30-May-95:          (ftp.uni-paderborn.de) 30-Jun-95:
  129.           Files:      16499                Files:      16621
  130.           Size:  2541109.4K                Size:  2543478.2K
  131.           Size:     2481.5M                Size:     2483.8M
  132.  
  133.       (ftp.uni-paderborn.de) 05-Jan-96: (ftp.doc.ic.ac.uk) 07-Feb-96:
  134.           Files:      24692                Files:      25497
  135.           Size:  3915876.0K                Size:  4163246.4K
  136.           Size:     3824.0M                Size:     4065.6M
  137.  
  138. ---------------------------------------------------------------------------
  139.  
  140.  All kinds of freely distributable programs (new software...) are accepted
  141.  as a contribution for this program. If you are a programmer, send me some
  142.  of your own code.
  143.  
  144.  Contributions and bug reports for this program should be sent to:
  145.  
  146.     E-Mail:           peoyli@pluggnet.se
  147.     WWW:              http://hotspot.pluggnet.se/~peoyli
  148.  
  149.     Snail Mail:       Per-Olof Yliniemi
  150.                       Box 78
  151.                       S-980 61 Tärendö
  152.                       SWEDEN
  153.  
  154. ---------------------------------------------------------------------------
  155.